home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 2: CDPD 1 / Almathera Ten on Ten - Disc 2: CDPD 1.iso / pd / 276-300 / 288 / plotdata2d / readme < prev    next >
Text File  |  1995-03-14  |  7KB  |  107 lines
  1. C======================================================================C
  2. C                                                                      C
  3. C    PlotData2D - two-dimensional data plotting package             C
  4. C                                                                      C
  5. C======================================================================C
  6. C                                                                      C
  7. C    Author: Robert C. Singleterry Jr.                              C
  8. C    Home Address:            School Address:                C
  9. C    365 Carol Ave.            1526 N. Santa Rita             C
  10. C    Idaho Falls, ID  83401        Tucson, AZ  85719              C
  11. C                                                                      C
  12. C    Origin Date: 11/01/89                                          C
  13. C    Lastest Update: 11/01/89                                       C
  14. C    Current Revision: 1.0                                          C
  15. C    Language: AC/FORTRAN V2.3                                      C
  16. C    (need this compiler to recompile the program)                  C
  17. C                                                                      C
  18. C======================================================================C
  19. C                                                                      C
  20. C Purpose:                                                             C
  21. C                                                                      C
  22. C    This program plots data onto a custom user defined screen and  C
  23. C    window using standard Amiga functions from AC/FORTRAN V2.3.    C
  24. C    The plot and screen/window definitions along with the (X,Y)    C
  25. C    data pairs are read in from a disk file.  In this revision,    C
  26. C    the disk file name is input through the command line           C
  27. C    interface.  The package supports linear, log-log, and          C
  28. C    semi-log axis plots.  The data can be plotted with lines,      C
  29. C    symbols, or lines and symbols.  As of now, all plots on one    C
  30. C    screen  must be the same.  See the examples on the              C
  31. C    distribution disk on exactly how to set up your data file.     C
  32. C    Preambles are included for the three axis types; however,      C
  33. C    the other options are what I use most often, which maybe       C
  34. C    the exact opposite of what you need.                           C
  35. C                                                                      C
  36. C    Many "extras" have been included:                              C
  37. C                                                                      C
  38. C    * Automatic axis size determination with some extra room       C
  39. C    * Border between the data and the axis                         C
  40. C    * Ability to access the screen depth gadget                    C
  41. C    * User defined Screen and Window dimensions                    C
  42. C    * Automatic value labeling on both axis                        C
  43. C    * User defined axis labels and plot title                      C
  44. C    * All border values are user defined                           C
  45. C    * Draws the coordinate axis on the graph                       C
  46. C                                                                      C
  47. C    Many "extras" will be include soon (see wish list).  Hopefully C
  48. C    another revision will be out before Jan. 1 1990!! (I also      C
  49. C    have to get my Master's thesis approved by then, so...).       C
  50. C                                                                      C
  51. C    This release is the basis to work from.  It is not intended    C
  52. C    to be a final release.  Please, if you have any comments,      C
  53. C    complaints, bugs, code, etc..., write me!!  Thanks.            C
  54. C                                                                      C
  55. C    Also, I am not too sure about what must be done to release     C
  56. C    this program to the general public?  AC/FORTRAN runtime        C
  57. C    library package problems.  However, I do know for a fact that  C
  58. C    using any or all of this program in a for-profit package will  C
  59. C    get you a visit from me and my BIG brother.  If you would like C
  60. C    to use any or all of this package in a public domain type      C
  61. C    program, remember to place somewhere in your program who       C
  62. C    actually sweated out the code!!!  Thanks                       C
  63. C                                                                      C
  64. C======================================================================C
  65. C                                                                      C
  66. C Usage:                                                               C
  67. C                                                                      C
  68. C    1> alias pd execute <volume:directory>plotdata2d.com           C
  69. C    1> pd <filename>                                               C
  70. C    1> pd h (to get help)                                          C
  71. C                                                                      C
  72. C    Note - DO NOT press <ctrl-C>.  To exit the program, activate   C
  73. C        the CLOSEWINDOW gadget.  Also do not execute the       C
  74. C        program directly.  Your individual stack size may not  C
  75. C        be large enough and a visit from the GURU may be next  C
  76. C        on the your hit parade.                                C
  77. C                                                                      C
  78. C======================================================================C
  79. C                                                                      C
  80. C Data Input:                                                          C
  81. C                                                                      C
  82. C    Command line: Data file name                                   C
  83. C                                                                      C
  84. C    Data file name: The data layout is as follows:                 C
  85. C                                                                      C
  86. C     1 - Screen height                                             C
  87. C     2 - Screen width                                              C
  88. C     3 - Window height                                             C
  89. C     4 - Window width                                              C
  90. C     5 - Window title (80 characters)                              C
  91. C     6 - X axis label (60 characters)                              C
  92. C     7 - Y axis label (60 characters)                              C
  93. C     8 - Left, Right, Top, Bottom axis offset from edge of window  C
  94. C     9 - Left, Right, Top, Bottom plot offset from item 8          C
  95. C    10 - User maximum refinement value                             C
  96. C    11 - User minimum refinement value                             C
  97. C    12 - Grid flag -> 0: No grid lines, 1: Grid lines              C
  98. C    13 - Plot type -> 0: Linear, 1: Log, 2: Semilog                C
  99. C    14 - Symbol flag -> 0: No symbols, 1: Symbols                  C
  100. C    15 - Line flag -> 0: No lines, 1: Draw lines                   C
  101. C    16 - Data Seperator -> The number that is used to              C
  102. C        seperate the lines from one another                    C
  103. C    17 - Plot data in X Y pairs with the plot lines                C
  104. C        seperated by data item 16                              C
  105. C                                                                      C
  106. C======================================================================C
  107.